home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / morse / cwdril / cwdrill.doc next >
Text File  |  1993-11-20  |  23KB  |  605 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                                                           1
  7.           CwDrill 1.4                                            Page
  8.           -----------------------------------------------------------------
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                      CwDrill 1.4 
  20.  
  21.  
  22.                               (c) Copyright AYMON & CO
  23.                                1376 Goumoens-la-Ville
  24.                                      Switzerland
  25.  
  26.  
  27.  
  28.  
  29.  
  30.           1. Introduction  . . . . . . . . . . . . . . . . . . . . . .    2
  31.  
  32.           2. Installation  . . . . . . . . . . . . . . . . . . . . . .    2
  33.  
  34.           3. Paddle Connection . . . . . . . . . . . . . . . . . . . .    2
  35.  
  36.           4. Starting CwDrill  . . . . . . . . . . . . . . . . . . . .    3
  37.  
  38.           5. Keying with the paddle  . . . . . . . . . . . . . . . . .    4
  39.                5.1. Menus  . . . . . . . . . . . . . . . . . . . . . .    4
  40.                5.2. Keying of numerical parameters . . . . . . . . . .    4
  41.                5.3. Choice of a file . . . . . . . . . . . . . . . . .    4
  42.  
  43.           6. Main Menu . . . . . . . . . . . . . . . . . . . . . . . .    5
  44.                6.1. Skill Drill  . . . . . . . . . . . . . . . . . . .    5
  45.                     6.1.1. Paddle  . . . . . . . . . . . . . . . . . .    6
  46.                     6.1.2. "World" parameters  . . . . . . . . . . . .    7
  47.                6.2. Keying practice  . . . . . . . . . . . . . . . . .    8
  48.                6.3. Copying practice . . . . . . . . . . . . . . . . .    9
  49.                6.4. Default values . . . . . . . . . . . . . . . . . .    9
  50.                6.5. Colour, Black-White  . . . . . . . . . . . . . . .    9
  51.                6.6. Fran ais, English, Deutsch . . . . . . . . . . . .    9
  52.  
  53.           7. Miscellaneous . . . . . . . . . . . . . . . . . . . . . .    9
  54.                7.1. Several configuration files  . . . . . . . . . . .    9
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.                                                                           2
  63.           CwDrill 1.4                                            Page
  64.           -----------------------------------------------------------------
  65.  
  66.  
  67.           1. Introduction
  68.  
  69.           CwDrill  is  an  interactive  program  which  allows to connect a
  70.           paddle directly to a  serial port  of a  PC, the  user thus being
  71.           able to exercise and improve both keying and copying.
  72.  
  73.           Its  Menu-oriented  style  makes CwDrill especially userfriendly.
  74.           CwDrill does not consider any  keyboard  input  (except  for Ctrl
  75.           Break), it is controlled by the paddle only. 
  76.  
  77.           Each copy is personalized by its owners callsign.
  78.  
  79.  
  80.           2. Installation
  81.  
  82.           CwDrill is supplied on a 3 1/2'' (720KB) disk containing at least
  83.           the following files:
  84.  
  85.           CWDRILL.EXE         the program as such
  86.  
  87.           PADDLE.EXE          a test  program,  which  controls  the paddle
  88.                               connection (see below)
  89.  
  90.           CWDRILL.QSO         a file containing a list of callsigns
  91.  
  92.           xxxx.CFG            a configuration  file which  contains all the
  93.                               program  parameters.   It   is  automatically
  94.                               rewritten  by  CwDrill  after  each  use  and
  95.                               therefore contains the last used values.
  96.  
  97.           CWDRILL.DOC         this file
  98.  
  99.           CwDrill does not need  any  special  installation.  On  hard disk
  100.           systems,  the  supplied  files  can  be  copied  into a directory
  101.           specially created for this purpose. A  backup copy  should always
  102.           be made. CwDrill is not copy protected.
  103.  
  104.  
  105.           3. Paddle Connection
  106.  
  107.           The paddle  is to  be connected directly to a serial port (port 1
  108.           or port 2) of the PC. The cable for this  purpose has  to be made
  109.           by  the  user.  For  this,  two  10K  resistances are needed. The
  110.           following connections have to be made:
  111.  
  112.  
  113.           1)   RTS and DATA CARRIER DETECT by a 10K resistance.
  114.           2)   RTS and RING INDICATOR by a 10K resistance.
  115.           3)   the "dot"-contact of the paddle to RING INDICATOR.
  116.           4)   the "dash"-contact of the paddle to DATA CARRIER DETECT.
  117.           5)   the paddle common to TD.
  118.  
  119.           The keyed morse code is output to DTR (RS-232 levels, abt. +- 10V)
  120.  
  121.           The pins of a 9 (25) pole plug are as follows:
  122.  
  123.             - RTS pin 7 (4)
  124.             - DATA CARRIER DETECT pin 1 (8)
  125.  
  126.  
  127.  
  128.  
  129.                                                                           3
  130.           CwDrill 1.4                                            Page
  131.           -----------------------------------------------------------------
  132.  
  133.  
  134.             - RING INDICATOR pin 9 (22)
  135.             - TD pin 3 (3)
  136.             - DTR pin 4 (20)
  137.             - GROUND pin 5 (7).
  138.  
  139.           The cable is then connected to port 1 of the PC to be tested with
  140.           the PADDLE program which indicates the state of the paddle: 
  141.  
  142.           Dash      : contact "dash" activated
  143.           Dot       : contact "dot" activated
  144.           Dot Dash  : both contacts activated
  145.  
  146.           If problems  occur, the tensions of the "dot" and "dash" contacts
  147.           of the paddle against the computer  ground must  be checked. Open
  148.           contact: more than 3 Volt (generally 3.5 V); closed contact: less
  149.           than -3 V (generally -9 V).  If necessary,  the resistance values
  150.           have to be reduced.
  151.  
  152.           Warning:  paddle common is about -10 V to computer ground.
  153.  
  154.           CwDrill can  only be  started if the paddle is properly wired and
  155.           plugged in.
  156.  
  157.  
  158.           4. Starting CwDrill
  159.  
  160.           Before starting CwDrill:
  161.  
  162.           -    set  the  directory  containing   CwDrill  as   the  current
  163.                directory
  164.           -    plug the paddle into port 1 or port 2.
  165.  
  166.           Then start CwDrill with the command:
  167.  
  168.           CWDRILL config port
  169.  
  170.           config:   name of  the configuration  file to  be used (extention
  171.                     .CFG). This file has to be in the current directory. 
  172.  
  173.           port:     number of port into which paddle is plugged.  It can be
  174.                     1 or 2. This parameter can be left out if it is port 1.
  175.  
  176.           Examples:
  177.  
  178.           CWDRILL HB9DBC
  179.  
  180.           cwdrill hb9dbc 2
  181.  
  182.           During  the  starting  phase  CwDrill  checks  if  the  paddle is
  183.           properly plugged in. It is  important  not  to  close  the paddle
  184.           contacts  during  this  phase,  otherwise  the message "Keyer not
  185.           connected (port x) will appear.
  186.  
  187.           The message "Illegal configuration file" appears if the file name
  188.           is not  correct, if  the file has been modified or rewritten by a
  189.           program other than CwDrill (using a text editor  e.g.) or  if the
  190.           file date is a later one than the system date. In such cases, the
  191.  
  192.  
  193.  
  194.  
  195.                                                                           4
  196.           CwDrill 1.4                                            Page
  197.           -----------------------------------------------------------------
  198.  
  199.  
  200.           original configuration file supplied with the  program has  to be
  201.           used or the system date must be corrected.
  202.  
  203.           When CwDrill is started correctly it shows its identification. To
  204.           go to the Main Menu, key anything.
  205.  
  206.  
  207.           5. Keying with the paddle
  208.  
  209.           5.1. Menus
  210.  
  211.           The Menus are presented in a  list of  elements. Each  element is
  212.           identified by a number. One element is highlighted.
  213.  
  214.           By keying "E", the highlight moves downwards.
  215.  
  216.           By keying "T", the highlight moves upwards.
  217.  
  218.           To select the highlighted element, "K" has to be keyed.
  219.  
  220.           Disregarding the  highlight, each element can also be selected by
  221.           keying its number.
  222.  
  223.           To leave a menu without selecting anything, "I" has to be keyed.
  224.  
  225.  
  226.           5.2. Keying of numerical parameters
  227.  
  228.           If a numerical parameter  needs to  be changed,  CwDrill opens an
  229.           editing window  and shows  the highest and lowest possible values
  230.           as well as the current parameter value.
  231.  
  232.           To edit new values, it is quite sufficient to key  these and then
  233.           "K".  The  new  value  is  only  accepted if contained within the
  234.           allowed range.
  235.  
  236.           The letters "O" and "T" can replace "0".
  237.  
  238.           Mistakes can be corrected  using  the  "Error"  sign  (8  dots or
  239.           more).
  240.  
  241.           To leave the editing window without modifying the value, "I" must
  242.           be keyed.
  243.  
  244.  
  245.           5.3. Choice of a file
  246.  
  247.           For file choice CwDrill opens a window in which all or a  part of
  248.           all possible files appear.
  249.  
  250.           One file  is highlighted. To move the highlight forwards, "E" has
  251.           to be keyed, to move it backwards, "T" must be keyed.
  252.  
  253.           To chose a file, the highlight must be placed on its name and the
  254.           "K" must be keyed.
  255.  
  256.           To leave the window without chosing, "I" has to be keyed.
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                                                                           5
  263.           CwDrill 1.4                                            Page
  264.           -----------------------------------------------------------------
  265.  
  266.  
  267.           Should the  window be  empty in  spite of the fact that there are
  268.           files in the directory, "T" has to be keyed several times to move
  269.           the highlight backwards.
  270.  
  271.  
  272.           6. Main Menu
  273.  
  274.           The Main Menu contains the following choices:
  275.  
  276.           1    Skill Drill
  277.           2    Keying practice
  278.           3    Reading practice
  279.           4    Set default values
  280.           5    Colour/Black-White
  281.           6    Fran ais, Deutsch
  282.           7    Back to DOS
  283.  
  284.  
  285.           6.1. Skill Drill
  286.  
  287.           This  is  the  main  CwDrill  exercise.  It  is not only the most
  288.           difficult one,  but  also  the  one  that  shows  the interactive
  289.           possibilities of CwDrill most clearly.
  290.  
  291.           This exercise contains the following menu:
  292.  
  293.           1    Begin
  294.           2    Paddle
  295.           3    "world" parameters
  296.           4    Duration (Min)
  297.           5    QSO File
  298.           6    Main menu
  299.  
  300.           The exercise starts by chosing "1". It runs as follows:
  301.  
  302.           A callsign  randomly chosen from a given file (QSO file parameter
  303.           of the menu) is "transmitted" by the loudspeaker at random speed,
  304.           pitch  and  style.  The  user  has  to  immediately  repeat  this
  305.           callsign. If he waits too long or makes  a mistake,  the callsign
  306.           is repeated  up to  3 times.  If he repeats correctly, his answer
  307.           time is taken and stored in  a statistic.  The exercise continues
  308.           with a  new callsign.  The duration of the exercise is determined
  309.           by the user.
  310.           The main window shows the exercise log. After each callsign a new
  311.           entry is  recorded in  the exercise log. It contains the callsign
  312.           and the keying speed as well  as  the  given  answers.  A missing
  313.           answer is  symbolised by  "~~~". If  the answer has been correct,
  314.           time needed and number  of  attempts  are  noted.  If  no correct
  315.           answer is  given, the  exercise is temporarily interrupted so the
  316.           callsign that was not copied can be read on the screen.
  317.  
  318.           A mistake can be corrected (as is done in normal transmission) by
  319.           keying a  numer of  "E" (at least 4) and then the callsign again.
  320.           As long as the delay between  two  signs  keyed    (including the
  321.           series  of  "E"  in  case  of  mistakes)  is  not longer than the
  322.           "patience"  parameter  (see  6.1.2),  the  correspondent  will be
  323.           waiting.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.                                                                           6
  330.           CwDrill 1.4                                            Page
  331.           -----------------------------------------------------------------
  332.  
  333.  
  334.           Instead of  a callsign,  QRS or  QRQ can  be keyed  to change the
  335.           speed of the correspondent.
  336.  
  337.           Also, QSD can be  keyed  to  improve  the  correspondent's keying
  338.           style. 
  339.  
  340.           To temporarily interrupt the exercise QRX or "EB" can be keyed. A
  341.           menu appears:
  342.  
  343.           1    Continue
  344.           2    Paddle
  345.           3    Abort
  346.  
  347.           "2" changes the paddle parameters (see 6.1.1).
  348.  
  349.           "3" or "I" return to exercise menu.
  350.  
  351.           The "statistics" window indicates how much time is left, how many
  352.           callsigns  have  been  transmitted,  how many callsigns have been
  353.           copied correctly, the average copying time as well  as the number
  354.           of callsigns copied per hour.
  355.  
  356.           After  the  set  duration  ("Duration" parameter, default value 3
  357.           minutes) or  by keying  QRT the  exercise is  interrupted and the
  358.           exercise menu  displayed. If  the log is not empty, there are two
  359.           more choices:
  360.  
  361.           6    Explore log file
  362.           7    Save log file
  363.  
  364.           Keying "6",  a log  window appears.  To move  forwards within the
  365.           log, "E" is keyed, backwards with "T" and return to the beginning
  366.           with "B".
  367.  
  368.           The "7" saves the log into a file the name  of which  should be a
  369.           number  between  1  and  9999  with  the  extention  ".LOG".  The
  370.           statistics appear in the log files as well.
  371.  
  372.  
  373.           Note:          The QSO files (extension  ".QSO")  are  text files
  374.                          with one callsign per line and contain up to 3'000
  375.                          lines. The callsigns can be replaced by figures or
  376.                          words.   The   file   taken  as  default  file  is
  377.                          CWDRILL.QSO. It contains callsigns of OM contacted
  378.                          by the author during contests.
  379.  
  380.  
  381.  
  382.           6.1.1. Paddle
  383.  
  384.           The  choice  of  this  option  allows  the modification of paddle
  385.           parameters. The following menu appears:
  386.  
  387.  
  388.           1    Speed
  389.           2    Pitch
  390.           3    Dash-Dot ratio (x1000)
  391.           4    Interval-Dot ratio (x1000)
  392.  
  393.  
  394.  
  395.  
  396.                                                                           7
  397.           CwDrill 1.4                                            Page
  398.           -----------------------------------------------------------------
  399.  
  400.  
  401.           5    Connection
  402.           6    Memory
  403.  
  404.           The default speed is 120  signs/minute  (based  on  the reference
  405.           word PARIS).
  406.  
  407.           The pitch default value is 800 Hz.
  408.  
  409.           The dash-dot ratio (x1000) default value is 3000.
  410.  
  411.           The interval-dot ratio (x1000) default value is 1000.
  412.  
  413.           The choice  of option  5 (connection) changes the polarity of the
  414.           paddle contacts. The default value is "Normal".
  415.  
  416.           The  choice  of  option  6  (memory)  enables  (or  disables) the
  417.           memorisation of  an element  (dash or dot) during the sending out
  418.           of a dot or dash. The default value is "Active".
  419.  
  420.           Warning:       A modification of paddle  parameters may  create a
  421.                          situation where nothing can be keyed correctly any
  422.                          longer. In a case like this,  nothing else remains
  423.                          to  be  done  except  pressing  down the keys Ctrl
  424.                          Break and then to key anything  in order  to leave
  425.                          the program without the parameters being saved.
  426.  
  427.  
  428.  
  429.           6.1.2. "World" parameters
  430.  
  431.           The   choice   of   this   option  allows  the  changing  of  the
  432.           correspondent's characteristics. The following menu appears:
  433.  
  434.  
  435.           1    Maximum speed
  436.           2    Minimum speed
  437.           3    Highest pitch
  438.           4    Lowest pitch
  439.           5    Delay between calls
  440.           6    Patience
  441.           7    Category 1
  442.           8    Category 2
  443.           9    Category 1 maximum speed
  444.  
  445.           As explained above, the callsigns of the correspondent are chosen
  446.           randomly from the QSO file.
  447.  
  448.           The correspondent's speed is chosen randomly between "max. speed"
  449.           (default 250) and "min. speed" (default 50).
  450.  
  451.           If the  chosen  speed  exceeds  the  "Category  1  maximum speed"
  452.           (default 100),  the correspondent  is automatically considered as
  453.           belonging to category 2  (rather fast),  otherwise as  category 1
  454.           (rather slow).
  455.  
  456.           The categories  1 and 2 allow to classify the keying style of the
  457.           correspondent randomly but according to certain percentages.
  458.  
  459.  
  460.  
  461.  
  462.  
  463.                                                                           8
  464.           CwDrill 1.4                                            Page
  465.           -----------------------------------------------------------------
  466.  
  467.  
  468.           There are  four possible  styles: electronic,  bug, straight good
  469.           and straight  poor. The  percentages of  each style can vary from
  470.           one  category  to  the  other.  The  default  percentages  are as
  471.           follows:
  472.  
  473.           Category 1:    Electronic 30%
  474.                          Bug 10%
  475.                          Straight (good) 30%
  476.                          Straight (poor) 30%
  477.  
  478.  
  479.           Category 2:    Electronic 60%
  480.                          Bug 30%
  481.                          Straight (good) 10%
  482.                          Straight (poor) 0%
  483.  
  484.  
  485.           This  means  that  in  category  1  there is a 30% probability of
  486.           encountering a correspondent with  an electronic  keying style, a
  487.           10% probability of a bug style etc... These percentages have been
  488.           chosen in such a way that in category  1 (rather  slow), there is
  489.           more  of  straight  keying  to  be encountered than in category 2
  490.           (rather fast).
  491.  
  492.           If  one  would  like  e.g.  that   all  correspondents   use  the
  493.           "electronic style", the following parameters have to be chosen:
  494.  
  495.           "Maximum  speed  category  1  =  same  value  as "Maximum speed".
  496.           Therefore all  correspondents will  be classified  in category 1.
  497.           One then fixes the "Electronic" percentage of category 1 to 100%.
  498.  
  499.           If one  desires that  all correspondents  should have one and the
  500.           same speed one fixes "Max. speed" = "Min. speed".
  501.  
  502.           The parameter "Delay between  calls" (default  3000 milliseconds)
  503.           fixes the time interval between two consecutive calls of the same
  504.           correspondent in case there should be no anwer, i.e. it fixes the
  505.           maximum  amount  of  time  available  until  the beginning of the
  506.           answer.
  507.  
  508.           The "patience"  parameter (default  1000 milliseconds) determines
  509.           the  time  a  correspondent  will wait after having "received" at
  510.           least a sign. This time is therefore identical  with the interval
  511.           between signs without the correspondent supposing that the answer
  512.           is finished.
  513.  
  514.  
  515.           6.2. Keying practice
  516.  
  517.           In this exercise the keyed signs appear directly in a window. The
  518.           menu allows the changing of the paddle parameters (see 6.1.1):
  519.  
  520.           CwDrill is  very tolerant  towards the  keying style of its user.
  521.           His style does not need to be perfect  in order  to be recognised
  522.           correctly.  To  describe  this  tolerance with words is, however,
  523.           impossible. Only the actual trying out can show this clearly.
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                                                                           9
  530.           CwDrill 1.4                                            Page
  531.           -----------------------------------------------------------------
  532.  
  533.  
  534.           CwDrill knows the shortcuts commonly used  like e.g.  "QR", "QS",
  535.           "CQ". 
  536.  
  537.           The sign  last keyed  can be deleted by keying "error" (8 dots or
  538.           more).
  539.  
  540.           By keying "SK" one returns to the exercise  menu. There  option 7
  541.           allows to return to the main menu.
  542.  
  543.  
  544.           6.3. Copying practice
  545.  
  546.           In this exercise CwDrill transmits text read from a file.
  547.  
  548.           The menu offers the following choices:
  549.  
  550.           1    Begin
  551.           2    Speed
  552.           3    Pitch
  553.           4    From the file
  554.           5    Duration (Min)
  555.           6    Main menu
  556.  
  557.           The  speed  is  defined  by  option 2 (default 150), the pitch by
  558.           option 3 (default  800),  the  text  file  (extention  ".TXT") by
  559.           option 4  (no default) and the duration by option 5. To return to
  560.           the main menu one  can either  chose option  6 or  key "I". Begin
  561.           exercise with option 1.
  562.  
  563.           During  the  "transmission",  the  "statistics" window shows time
  564.           left and number of signs  transmitted.  The  transmission  can be
  565.           interrupted by  keying any  sign. A menu permitting to change the
  566.           transmission parameters or to abort the exercise then appears.
  567.  
  568.  
  569.           6.4. Default values
  570.  
  571.           This choice sets the parameters to their default  values. Default
  572.           values are explained in the appropriate places of this document.
  573.  
  574.  
  575.           6.5. Colour, Black-White
  576.  
  577.           This option  allows to  chose a colour or black and white screen.
  578.           The type of screen is saved in the configuration file.
  579.  
  580.  
  581.           6.6. Fran ais, English, Deutsch
  582.  
  583.           CwDrill speaks 3 languages. The choice of this option
  584.           allows the changing into another of the specified languages.
  585.  
  586.  
  587.           7. Miscellaneous
  588.  
  589.           7.1. Several configuration files
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                                                                          10
  596.           CwDrill 1.4                                            Page
  597.           -----------------------------------------------------------------
  598.  
  599.  
  600.           If severals people use  the same  program, each  one of  them can
  601.           have  his  (or  her)  own  configuration  file.  To  create a new
  602.           configuration, simply make a  copy of  the original configuration
  603.           file.
  604.  
  605.